跳到主要内容

SmartAgent Version 10.1.1

发布日期：2026 年 6 月 23 日

版本概述​

SmartAgent 10.1.1 为 10.1.x 功能增强版本，由于 10.1.0 版本未单独发布，其变更内容已合入 10.1.1 一并发布。新增 ESM 应用监控、watchdog 状态守护、系统时间跳变检测 等 SmartAgent 自身能力，并集成 JavaAgent 9.14.0、NodejsAgent 8.0.0、NginxAgent 3.10.0 等多个子探针升级；各语言探针统一支持 HTTP 响应头插码开关控制。

  • ✨ ESM 应用监控：agentloader 支持自动监控 ECMAScript Module（ESM）应用；NodejsAgent 8.0.0 新增 ESM 监控支持

  • ✨ SmartAgent 自身增强：watchdog 定时检查 agent.status 并恢复异常值；系统时间跳变超过 30s 自动退出重启；Serverless 探针包新增内置 CA 根证书

  • ✨ 多探针升级：JavaAgent 9.14.0、DotnetAgent 6.16.1、PHPAgent 8.7.0、PythonAgent 8.7.4、NginxAgent 3.10.0、ApacheAgent 3.5.0、SDKAgent 5.16.0

  • 🔧 通用优化：优化 cgroup v2 指标采集、uvicorn 进程组识别、非 root 安装权限及安装命令兼容性

  • 🔧 10.1.1 修复：修复 NODE_OPTIONS 非空导致 Node.js 应用启动失败（影响范围：10.1.0）

升级建议
  • 使用 ESM 模块 或 Node.js 14.18+ 异步密集场景的用户，建议升级以获得 ESM 监控与 AsyncLocalStorage 异步追踪优化；
  • 使用 10.1.0 版本且 Node.js 应用启动受 NODE_OPTIONS 影响的环境，建议尽快升级至 10.1.1；
  • 需 HTTP 响应头插码开关控制、采样模式/智能强度叠加阈值模式 或 容器 cgroup v2 指标 的场景应优先升级。

Linux x86_64 系统​

支持平台版本​

  • One 平台：V2.2.2 及以上版本

集成探针版本​

  • JavaAgent: 9.14.0
  • DotnetAgent: 6.16.1
  • PHPAgent: 8.7.0
  • PythonAgent: 8.7.4
  • NodejsAgent: 8.0.0
  • NginxAgent: 3.10.0
  • ApacheAgent: 3.5.0
  • SDKAgent: 5.16.0
  • GoAgent: 5.0.3
  • logsAgent: 3.0.1

新增功能​

  1. watchdog 状态守护：定时检查 agent.status 变更并恢复异常值（每隔 2 秒检查，内容不是 on 时自动恢复为 on 并打印一次告警）。
  2. agentloader 支持 ESM 应用监控：支持自动监控 ECMAScript Module（ESM）应用。
  3. Serverless 探针包新增 certs 目录：内置 CA 根证书（CA Bundle）。
  4. 系统时间变更检测：时间跳变超过 30s 阈值时自动退出重启。

功能优化与修复​

1. JavaAgent 升级至 9.14.0​

新增功能

  • weblogic-12.2.1.4.0 数据库连接池适配；
  • log4j2 日志染色支持 jackson layouts；
  • 支持开关控制 HTTP 响应头是否插码；
  • 调用链采集模式根据配置叠加采集慢错调用。

2. DotnetAgent 升级至 6.16.1​

新增功能

  • 支持开关控制 HTTP 响应头是否插码；
  • 支持采样模式/智能强度叠加阈值模式。

3. PHPAgent 升级至 8.7.0​

新增功能

  • 支持开关控制 HTTP 响应头是否插码。

修复 Bug

  • 修复 ZTS 多线程可能导致的崩溃问题（例：apache event/worker + libphp.so）（影响范围：PHPAgent 8.7.0 之前版本，对应 SmartAgent 10.1.0 之前版本）。

4. PythonAgent 升级至 8.7.4​

新增功能

  • 支持开关控制 HTTP 响应头是否插码；
  • 适配小睿使用场景。

5. NodejsAgent 升级至 8.0.0​

新增功能

  • 新增对 ECMAScript Module（ESM）应用的监控支持（需搭配 SmartAgent 10.1.0+ 探针）；
  • 新增 mongoose 8.23.0、5.13.22、amqplib 0.10.0、0.10.9、ioredis 5.8.2、Elasticsearch 16.7.1 与 Express 4.19.2 适配；
  • 新增 Span 代码文件信息，并补充部分链路节点的组件标识；
  • 新增适配 node v24.14.1、v14.21.3；
  • 支持开关控制 HTTP 响应头是否插码。

功能优化

  • 优化异步上下文追踪机制：对于 Node.js 14.18 及以上版本，且运行时具备 AsyncLocalStorage.enterWith 能力的应用，Agent 默认使用 AsyncLocalStorage 进行事务上下文传播，降低传统 async_hooks Map 追踪在 Promise、async/await、定时器等异步密集场景下的性能开销。
  • 建议：如果被监控应用密集使用 Promise、async/await 或高频异步任务，建议将 Node.js 升级到 14.18 及以上版本，以获得更好的异步追踪性能。

修复 Bug

  • 修复部分异步场景下调用链关联异常的问题，确保 Span 父子关系正确（影响范围：NodejsAgent 8.0.0 之前版本，对应 SmartAgent 10.1.0 之前版本）。

6. NginxAgent 升级至 3.10.0​

新增功能

  • 支持开关控制 HTTP 响应头是否插码；
  • nginx、openresty 新版本适配：
    • nginx：1.28.1～1.28.3；1.29.4～1.29.8；1.30.0～1.30.2；1.31.0～1.31.1
    • openresty：1.29.2.*

7. ApacheAgent 升级至 3.5.0​

新增功能

  • 支持开关控制 HTTP 响应头是否插码。

修复 Bug

  • 修复 JS 注入 script 标签被截断导致 HTML 页面渲染异常（影响范围：ApacheAgent 3.5.0 之前版本，对应 SmartAgent 10.1.0 之前版本）。

8. SDKAgent 升级至 5.16.0​

新增功能

  • 允许 dotnet 支持开关控制 HTTP 响应头是否插码；
  • 支持采样模式智能强度叠加阈值模式；
  • 完善 elasticsearch 后端 detail 字段。

9. SmartAgent 自身优化与修复​

功能优化

  • 优化 uvicorn 进程组识别：当无法定位 uvicorn module 入口文件时，module 属性直接使用原始值；
  • 移除非 root 安装时修改 /home 目录权限导致的报错；
  • 优化 SmartAgent 安装命令中存在与安装进程 pid 相同数字时导致无法安装的场景；
  • 优化 cgroup v2 指标采集：改为读取 cgroup v2 memory.max 作为内存硬限制，清理 cpu.max 为 max 时残留的 quota，并累加 cgroup v1/v2 多设备 blkio 数据，避免容器内存、CPU 限额和块 IO 指标上报不准。

修复 Bug--此部分为10.1.1版本更新内容，其余均为10.1.0版本更新内容

  • 修复 NODE_OPTIONS 非空导致 Node.js 应用启动失败（影响范围：SmartAgent 10.1.0）。

Linux ARM64 系统​

支持平台版本​

  • One 平台：V2.2.2 及以上版本

集成探针版本​

  • JavaAgent: 9.14.0
  • DotnetAgent: 6.16.1
  • PHPAgent: 8.7.0
  • PythonAgent: 8.7.4
  • NginxAgent: 3.10.0
  • SDKAgent: 5.16.0
  • GoAgent: 5.0.3
  • logsAgent: 3.0.1

新增功能​

  1. watchdog 状态守护（同 Linux x86_64）。
  2. agentloader 支持 ESM 应用监控（同 Linux x86_64）。
  3. Serverless 探针包新增 certs 目录（同 Linux x86_64）。
  4. 系统时间变更检测（同 Linux x86_64）。

功能优化与修复​

平台说明

本平台的功能更新与 Linux x86_64 系统基本一致，主要差异为探针支持范围。具体包括：

功能优化与修复

  • 同 Linux x86_64（含 JavaAgent 9.14.0、DotnetAgent 6.16.1、PHPAgent 8.7.0、PythonAgent 8.7.4、NginxAgent 3.10.0、SDKAgent 5.16.0 升级及 SmartAgent 自身优化）

注意事项

  • ARM64 平台暂不支持 NodejsAgent、ApacheAgent

Windows x86_64 平台​

支持平台版本​

  • One 平台：V2.2.2 及以上版本

集成探针版本​

  • JavaAgent: 9.14.0
  • DotnetAgent: 6.16.1
  • logsAgent: 3.0.1

新增功能​

  1. watchdog 状态守护：定时检查 agent.status 变更并恢复异常值（每隔 2 秒检查，内容不是 on 时自动恢复为 on 并打印一次告警）。
  2. Serverless 探针包新增 certs 目录：内置 CA 根证书（CA Bundle）。
  3. 系统时间变更检测：时间跳变超过 30s 阈值时自动退出重启。

功能优化与修复​

1. JavaAgent 升级至 9.14.0​

新增功能

  • weblogic-12.2.1.4.0 数据库连接池适配；
  • log4j2 日志染色支持 jackson layouts；
  • 支持开关控制 HTTP 响应头是否插码；
  • 调用链采集模式根据配置叠加采集慢错调用。

2. DotnetAgent 升级至 6.16.1​

新增功能

  • 支持开关控制 HTTP 响应头是否插码；
  • 支持采样模式/智能强度叠加阈值模式。

3. SmartAgent 自身优化​

功能优化

  • 优化 uvicorn 进程组识别：当无法定位 uvicorn module 入口文件时，module 属性直接使用原始值。

兼容性说明​

平台兼容性​

操作系统支持架构最低 One 版本
Linuxx86_64V2.2.2
LinuxARM64V2.2.2
Windowsx86_64V2.2.2